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Hr. 
榜样 很 重要 。 
-- 《机 械 战 营 》 Alex J. Murphy 警官 
这 份 指南 旨 在 提供 一 系列 Ruby on Rails 4 开发 的 最 佳 实践 和 风格 惯例 。 本 指南 与 
社区 驱动 并 制定 的 Ruby 编码 风格 指南 可 以 互 为 补充 。 
本 文中 的 一 些 建议 只 适用 于 Rails 4.0+ 版 本 。 
你 可 以 使 用 Transmuter 来 生成 本 文 的 PDF 或 HTML 版本。 
本 指南 同时 有 以 下 语言 的 翻译 版 : 
英文 原版 
繁体 中 文 
日 语 
俄语 
土耳其 语 


Rails 风格 指南 


这 份 Rails 风格 指南 推荐 的 是 Rails 的 最 佳 实践 ， 现 实 世 界 中 的 Rails 程序 员 据 此 可 
以 写 出 可 维护 的 高 质量 代码 。 我 们 只 说 实际 使 用 中 的 用 法 。 指 南 再 好 ， 但 里 面 说 的 
过 于 理想 化 结果 大 家 拒绝 使 用 或 者 可 能 根本 没 人 用 ， 又 有 何 意 义 。 

本 指南 分 为 几 个 小 节 ， 每 一 小 节 由 几 条 相关 的 规则 构成 。 我 尽力 在 每 条 规则 后 面 说 
明理 由 (如果 省 略 了 说 明 ， 那 是 因为 其 理由 显而易见 ) 。 


这 些 规则 不 是 我 凭空 想象 出 来 的 它们 中 的 绝 大 部 分 来 自我 多 年 以 来 作为 职业 软 
件 工程 师 的 经 验 ， 来 自 Rails 社区 成 员 的 反馈 和 建议 ， 以 及 许多 备 受 推 党 的 Rails 
编程 资源 。 
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配置 


e 自 定 义 的 初始 化 代码 应 放 在 config/initializers 


H3 F  Initializers 目 
录 中 的 代码 在 应 用 启动 时 被 执行 。[inh 


e 每 个 gem 的 初始 化 代码 应 放 在 单独 的 文件 中 ， 并 且 文 件 名 应 与 gem 的 名 称 相 
同 。 例 如 : carrierwave.rb , active admin.rb ° Iink] 
e 相应 地 调整 开发 环境 、 测 试 环境 及 生产 环境 的 配置 (修改 
config/environments/ 目录 下 对 应 的 文件 ) [link] 
o 添加 需要 预 编 译 的 额外 静态 资源 文件 (如 果 有 的 话 ) 
`` ` Ruby 
# config/environments/production.rb 


# 预 编译 额外 的 静态 资源 文件 (application.js，application.css， 以 及 
config.assets.precompile += %w( rails admin/rails admin.css 


sj zm 





e 将 所 有 环境 下 都 通用 的 配置 放 在 config/application.rb 文件 中 。[ing] 
e 创建 一 个 与 生产 环境 高 度 相似 的 staging Iž o link] 


。 其 它 配置 应 保存 在 YAML 文件 中 ， 存 放 在 config/ Bx Link] 


从 Rails 4.2 开始 ， 可 以 通过 config for 


这 个 新 方法 轻松 地 加 载 YAML 配 
置 文件 : 


Rails::Application.config for(:yaml file) 


路 由 


e 当 需 要 为 一 个 RESTful 资源 添加 动作 时 (Ay 05 X95 2) ， 应 使 用 
member 路 由 和 collection &u e [link] 


8 E 
get 'subscriptions/:id/unsubscribe' 
resources :subscriptions 


# 好 
resources :Subscriptions do 

get 'unsubscribe', on: :member 
end 


H E 
get 'photos/search' 
resources :photos 


3S 
resources :photos do 

get 'search', on: :collection 
end 


e 当 需 要 定义 多 个 member/collection 路 由 时 ， 应 使 用 块 结构 。[ing] 


resources :subscriptions do 
member do 
get 'unsubscribe' 
# 更 多 路 由 
end 
end 


resources :photos do 
collection do 
get 'search' 
# 更 多 路 由 
end 
end 


e dt] Æ d (nested routes)， 它 可 以 更 有 效 地 表现 ActiveRecord 模型 之 间 
的 关系 。[linK] 


class Post « ActiveRecord::Base 
has many :comments 
end 


class Comments « ActiveRecord::Base 
belongs to :post 
end 


# routes.rb 

resources :posts do 
resources :comments 

end 


e 使 用 命名 空间 路 由 来 归 类 相关 的 动作 。[linhk] 


namespace :admin do 
# 将 请 求 /admin/products/* 交 由 Admin::ProductsController 处 理 
# (app/controllers/admin/products controller.rb) 
resources :products 

end 


A | 
e 不 要 使 用 旧式 的 控制 器 路 由 。 这 种 路 由 会 让 控制 器 的 所 有 动作 都 通过 GET 请 
求 调用 [ink 


# 非常 差 
match ':controller(/:action(/:id(.:format)))' 


e 不 要 使 用 match 来 定义 任何 路 由 ， 除 非 确 实 需 要 将 多 种 请 求 映 射 到 某 个 动 
作 ， 这 时 可 以 通过 via 选项 来 指定 请 求 类 型 ， 如 


[:get, :post, :patch, :put, :delete] ° [ink] 


控制 器 
e 控制 器 应 该 保持 苗条 一 它们 应 该 只 为 视图 层 提供 数据 ， 不 应 包含 任何 业务 逻 
辑 (所 有 业务 逻辑 都 应 当 放 在 模型 里 ) o link] 


e 每 个 控制 器 的 动作 (理论 上 ) 应 当 只 调用 一 个 除了 初始 的 find 或 new 之 外 的 
je [link] 


e 控制 器 与 视图 之 问 共享 不 超过 两 个 实例 变量 。 link] 


模型 
e 自由 地 引入 不 是 ActiveRecord 的 模型 类 。 [link] 


e 模型 的 命名 应 有 意义 (但 简短 ) 且 不 含 缩写 。 Dind 


e 如 果 需 要 模型 类 有 与 ActiveRecord 类 似 的 行为 ( 如 验证 ) ， 但 又 不 想 有 
ActiveRecord 的 数据 库 功 能 ， 应 使 用 ActiveAttr 这 个 gem 。[ing] 


class Message 
include ActiveAttr::Model 


attribute :name 
attribute :email 
attribute :content 
attribute :priority 


attr accessible :name, :email, :content 
validates presence of :name 
validates format of :email, :with => /NA[-a-z0-9 -**.]*NG([-a- 


validates length of :content, :maximum -» 500 
end 


EJE) 


更 完整 的 示例 请 参考 RailsCast on the subject » 





ActiveRecord 


e 避免 改动 缺 省 的 ActiveRecord 惯例 ( 表 的 名 字 、 主 键 等 ) ， 除 非 你 有 一 个 充 
分 的 理由 (比如 ， 不 受 你 控制 的 数据 库 ) o [link] 


H 差 - 如 果 你 能 更 改 数据 库 的 Schema， 那 就 不 要 这 样 写 

class Transaction < As tiveRecord::Base 
self.table name = 'order' 

end 


e 把 宏 风 格 的 方法 调用 ( has many , validates 等 ) 放 在 类 定义 语句 的 最 前 
, [link] 


class User « ActiveRecord::Base 


# 默认 的 scope 放 在 最 前 (如 果 有 的 话 ) 
default scope { where(active: true) } 


# 接 下 来 是 常量 初始 化 
COLORS = %w(red green blue) 


# 然后 是 attr 相关 的 宏 
attr accessor :formatted date of birth 


attr accessible :login, :first name, :last name, :email, :pas 


H 紧 接 着 是 与 关联 有 关 的 宏 
belongs_to :country 


has many :authentications, dependent: :destroy 

# 以 及 与 验证 有 关 的 宏 

validates :email, presence: true 

validates :username, presence: true 

validates :username, uniqueness: { case sensitive: false } 
validates :username, format: ( with: /NA[A-Za-z][^-Za-z0-9. - 
validates :password, format: ( with: /NANS(8,128)Nz/, allow r 


B 下 面 是 回调 方法 
before save :cook 
before save :update username lower 


# 其 它 的 宏 (de devise) 应 放 在 回调 方法 之 后 





has many :through T has and belongs to many ° 使 用 
has many :through 允许 join 模型 有 附加 的 属性 及 验证 。[inh] 


# 不 太 好 - 使 用 has and belongs to many 
class User < ActiveRecord::Base 

has and belongs to many :groups 
end 


class Group « ActiveRecord::Base 
has and belongs to many :users 
end 


# 更 好 - 使 用 has many :through 
class User < ActiveRecord::Base 

has many :memberships 

has many :groups, through: :memberships 
end 


class Membership « ActiveRecord::Base 
belongs to :user 
belongs to :group 

end 


class Group « ActiveRecord::Base 

has many :memberships 

has many :users, through: :memberships 
end 


e self[:attribute] 比 read attribute(:attribute) £r. [ink] 


es 
def amount 

read attribute(:amount) * 100 
end 


H 好 

def amount 
self[:amount] * 100 

end 


e self[:attribute] = value f 


write attribute(:attribute, value) o [link] 


# 差 

def amount 
write_attribute(:amount, 100) 

end 


#8 好 

def amount 
self[:amount] = 100 

end 


e 总 是 使 用 新 式 的 "sexy" i e ink] 


kil — } 


# 差 
validates_presence_of :email 
validates length of :email, maximum: 100 


# 好 
validates :email, presence: true, length: { maximum: 100 } 


当 一 个 自 定义 的 验证 规则 使 用 次 数 超过 一 次 时 ， 或 该 验证 规则 是 基于 正则 表达 


式 时 ， 应 该 创建 一 个 自 定义 的 验证 规则 文件 。 [in 


8 x 
class Person 

validates :email, format: ( with: /NA([^QNs]*)0((?:[-a-z0-9]4 
end 


# 好 
class EmailValidator < ActiveModel::EachValidator 
def validate each(record, attribute, value) 
record.errors[attribute] «« (options[:message] || 'is not e 
end 
end 


class Person 
validates :email, email: true 
end 





自 定义 验证 规则 应 放 在 app/validators 目录 下 。 [link] 


o 如 果 你 在 维护 数 个 相关 的 应 用 ， 或 验证 规则 本 身 足够 通用 ， 可 以 考虑 将 自 定义 


的 验证 规则 抽象 为 一 个 共用 的 gem o [link] 


自由 地 使 用 命名 scope。 link] 


class User « ActiveRecord::Base 
scope :active, -» ( where(active: true) ) 
scope :inactive, -» ( where(active: false) ) 


scope :with orders, -» ( joins(:orders).select('distinct(user 
end 


«| B 

e 当 一 个 由 lambda 和 参数 定义 的 命名 scope 太 过 复杂 时 ， 更 好 的 方式 是 创建 
一 个 具有 同样 用 途 并 返回 ActiveRecord::Relation 对 象 的 类 方法 。 这 很 可 
能 让 scope 更 加 精简 。 [link] 

















class User < ActiveRecord::Base 
def self.with orders 
joins(:orders).select('distinct(users.id)') 
end 
end 


注意 这 种 方式 不 允许 命名 socpe 那样 的 链 式 调用 。 例 如 : 


# 不 能 链 式 调用 
class User < ActiveRecord::Base 
def User.old 
where('age » ?', 80) 
end 


def User.heavy 
where('weight » ?', 200) 
end 
end 


这 种 方式 下 old 和 heavy 可 以 单独 工作 ， 但 不 能 执行 
User.old.heavy ° 若 要 链 式 调用 ， 请 使 用 下 面 的 代码 : 


# 可 以 链 式 调用 
class User < ActiveRecord::Base 

scope :old, -> ( where('age > 60') } 

scope :heavy, -> { where('weight > 200') } 
end 


r 


e 注意 update attribute 方法 的 行为 。 它 不 运行 模型 验证 (与 
update attributes 不 同 ) ， 因 此 可 能 弄 乱 模型 的 状态 。[ink] 


e 应 使 用 对 用 户 友好 的 URL。URL 中 应 显示 模型 的 一 些 具有 描述 性 的 属性 ， 而 
不 是 仅仅 显示 id 。 有 多 种 方法 可 以 达到 这 个 目的 : nk] 


o 重 写 模型 的 to param 方法 。Rails 使 用 该 方法 为 对 象 创建 URL 。 该 方 
法 默认 会 以 字符 串 形式 返回 记录 的 id 项 。 可 以 重 写 该 方法 以 包含 其 它 
可 读 性 强 的 属性 。 


class Person 
def to param 
"Z(id) £(namej".parameterize 
end 
end 


为 了 将 结果 转换 为 一 个 URL 友好 的 值 ， 字 符 串 应 该 调用 parameterize 7 
法 。 对 象 的 id 属性 值 需要 位 于 URL 的 开头 ， 以 便 使 用 ActiveRecord 的 
find 方法 查找 对 象 。 


o 使 用 friendly id 这 个 gem。 它 允许 使 用 对 象 的 一 些 描述 性 属性 而 非 
id 来 创建 可 读 性 强 的 URL。 


class Person 

extend FriendlyId 

friendly id :name, use: :slugged 
end 


查看 gem documentation 以 获得 更 多 friendly id 的 使 用 信息 。 


e 应 使 用 find each 来 迭代 一 系列 ActiveRecord 对 象 。 用 循环 来 处 理 数据 库 
中 的 记录 集 (如 all 方法 ) 是 非常 低 效 率 的 ， 因 为 循环 试图 一 次 性 得 到 所 有 
对 象 。 而 批 处 理 方 法 允许 一 批 批 地 处 理 记录 ， 因 此 需要 占用 的 内 郁 大 幅 减 少 。 
[link] 


H 差 

Person.all.each do |person| 
person.do awesome stuff 

end 


Person.where('age > 21').each do |person| 
person.party all night! 
end 


# 好 

Person.find each do |person| 
person.do awesome stuff 

end 


Person.where('age » 21').find each do |person| 
person.party all night! 
end 


e 因为 Rails 为 有 依赖 关系 的 关联 添加 了 回调 方法 ， 应 总 是 调用 
before destroy 回调 方法 ， 调 用 该 方法 并 启用 prepend: true 选项 会 执 
行 验证 nk] 





# 差 一 即使 super admin 返回 true，roles 也 会 自动 删除 
has many :roles, dependent: :destroy 


before destroy :ensure deletable 
def ensure deletable 
fail "Cannot delete super admin." if super admin? 


end 


# 好 
has many :roles, dependent: :destroy 


before destroy :ensure deletable, prepend: true 
def ensure deletable 


fail "Cannot delete super admin." if super admin? 
end 


ActiveRecord 查询 


e 不 要 在 查询 中 使 用 字符 串 插 值 ， 它 会 使 你 的 代码 有 被 SQL 注入 攻击 的 风险 。 
[link] 


# 差 一 插值 的 参数 不 会 被 转 义 
Client.where("orders count = #{params[:orders]}") 





# 好 一 参数 会 被 适当 转 义 
Client.where('orders count = ?', params[:orders]) 


e 当 查询 中 有 超过 1 个 占 位 符 时 ， 应 考虑 使 用 名 称 占 位 符 ， 而 非 位 置 占 位 符 。 
[link] 


# 一 般 般 

Client.where( 
'created at »- ? AND created at «- ?', 
params[:start date], params[:end date] 


) 
uox 
Client.where( 


'created at »- :start date AND created at «- :end date', 
start date: params[:start date], end date: params[:end date] 


UN ë LH 
。 当 只 需要 通过 id 查询 单个 记录 时 ， 优 先 使 用 find 而 不 是 where 。 link] 


H 差 
User.where(id: id).take 


# 好 
User.find(id) 


e 当 只 需要 通过 属性 查询 单个 记录 时 ， 优 先 使 用 find by 而 不 是 where » 
[link] 


8 差 
User.where(first name: 'Bruce', last name: 'Wayne').first 


gH 
User.find by(first name: 'Bruce', last name: 'Wayne') 


e 当 需 要 处 理 多 条 记录 时 ， 应 使 用 find each e link] 


4 差 一 一 次 性 加 载 所 有 记录 
# 当 users 表 有 成 千 上 万 条 记录 时 ， 非 常 低 效 
User.all.each do |user| 


NewsMailer.weekly(user).deliver now 
end 


# 好 一 分 批 检 索 记 录 
User .find each do [user | 


NewsMailer.weekly(user).deliver now 
end 


where.not 比 书写 SQL 更 好 。 [link] 


# 差 
User.where("id != ?", id) 


H a 
User.where.not(id: id) 


迁移 


e 应 使 用 版 本 控制 工具 记录 schema.rb (A structure.sql ) 的 变化 。 
[link] 


e 应 使 用 rake db:scheme:load 而 不 是 rake db:migrate 来 初始 化 空 数 
è o link 


。 应 在 迁移 文件 中 设置 默认 值 ， 而 不 是 在 应 用 层面 设置 。[inh 


E 差 一 在 应 用 中 设置 默认 值 
def amount 

self[:amount] or 0 
end 


虽然 许多 Rails 开发 者 建议 在 Rails 中 强制 使 用 表 的 默认 值 ， 但 这 会 使 数据 受 
到 许多 应 用 bug 的 影响 ， 因 而 导致 应 用 极其 难以 维护 。 考 虑 到 大 多 数 有 一 定 规 
模 的 Rails 应 用 都 与 其 它 应 用 共享 数据 库 ， 保 持 应 用 的 数据 完整 性 几乎 是 不 可 
能 的 。 

e 务必 使 用 外 键 约 束 。 在 Rails 4.2 中 ，ActiveRecord 本 身 已 经 支持 外 键 约束 。 
[link] 


e 书写 建设 性 的 迁移 〈 添 加 表 或 列 ) 时 ， 应 使 用 change 方法 而 不 是 up 或 
down Zik link] 


H CASO 
class AddNameToPeople « ActiveRecord::Migration 
def up 
add column :people, :name, :string 
end 


def down 
remove column :people, :name 
end 
end 


4 新 式 写 法 (更 好 ) 
class AddNameToPeople < ActiveRecord::Migration 
def change 
add column :people, :name, :string 
end 
end 


e 不 要 在 迁移 中 使 用 模型 类 。 由 于 模型 的 变化 ， 模 型 类 也 一 直 处 在 变化 当中 ， 过 
去 运行 正常 的 迁移 可 能 不 知 什么 时 候 就 不 能 正常 进行 了 。 link 


视图 


e 不 要 直接 从 视图 调用 模型 层 。[linK] 


e 复杂 的 格式 化 不 应 放 在 视图 中 ， 而 应 提取 为 视图 helper 或 模型 中 的 方法 。 
[link] 


。 应 使 用 partia 模版 与 布局 来 减少 代码 重复 。 link 


国际 化 


e 不 应 在 视图 、 模 型 或 控制 器 里 添加 语言 相关 的 设置 ， 应 在 config/locales 
目录 下 进行 设置 。[linK] 


e 当 ActiveRecord 模型 的 标签 需要 被 翻译 时 ， 应 使 用 activerecord scope: 
[link] 


en: 
activerecord: 
models: 
user: Member 
attributes: 
user: 
name: "Full name" 


然后 User.model name.human 会 返回 "Member"” > m 
User.human attribute name("name") 会 返回 "Full name" » 3x X E PE 6 $i] 
译 会 作为 视图 中 的 标签 。 
e 把 在 视图 中 使 用 的 文字 与 ActiveRecord 的 属性 翻译 分 开 。 把 模型 使 用 的 语言 
文件 放 在 models 目录 下 ， 把 视图 使 用 的 文字 放 在 views 目录 下 。[ing 


o 当 使 用 额外 目录 来 设置 语言 文件 时 ， 应 在 application.rb 文件 里 列 出 
这 些 目录 以 加 载 设 置 。 


# config/application.rb 
config.ii18n.load path += Dir[Rails.root.join('config', '1 
加 二 一 一 


e 把 共享 的 本 地 化 选项 ， 如 日 期 或 货币 格式 ， 放 在 locales 的 根 目 录 下 。 
[link] 





e 应 使 用 精简 形式 的 118n Zik: 使 用 I18n.t 而 非 I18n.translate ; 使 
用 Il8n.1 而 非 I48n.localize 。[ink] 


。 应 使 用 "懒惰" 查询 来 获取 视图 中 使 用 的 文本 。 假 设 我 们 有 以 下 结构 : 【InN 


en : 
users: 
show: 

title: "User details page" 


users.show.title 的 数值 能 这 样 被 app/views/users/show.html.haml 
获取 : 


= t title' 


e 应 在 控制 器 与 模型 中 使 用 点 分 隔 的 键 ， 而 非 指定 :scope 选项 。 点 分 隔 的 调 
用 更 容易 阅读 ， 也 更 易 追 踪 层级 关系 。[ ng 
NE 
I18n.t :record invalid, :scope -» [:activerecord, :errors, :mes 


uU 
I18n.t 'activerecord.errors.messages.record invalid' 


a] 8 





o 更 详细 的 Rails i18n 信息 可 以 在 Rails Guides 找到 。 [ink] 


Assets 


应 使 用 assets pipeline 来 管理 应 用 的 资源 结构 。 


e 自 定义 的 样式 表 、JavaScript 文件 或 图 片 文件 ， 应 放 在 app/assets 目录 
下 。[ink 


e 把 自己 开发 但 不 好 归 类 的 库 文 件 ， 应 放 在 lib/assets/ BT link] 


大 大 一 


e 第 三 方 代码 ， 如 jQuery 或 bootstrap， 应 放 在  vendor/assets 目录 下 。 
[link] 

e 尺 可 能 使 用 资源 的 gem 版 。 例 如 : jquery-rails, jquery-ui-rails, bootstrap- 
sass, zurb-foundation [link] 


Mailers 
e ni mailer 命名 为 SomethingMailer 。 若 没有 Mailer 后 级 ， 不 能 立即 断定 
它 是 否 为 一 个 mailer， 也 不 能 断定 哪个 视图 与 它 有 关 。 link] 
e. 提供 HTML 与 纯 文本 两 份 视图 模版 。 link] 


e 在 开发 环境 下 应 显示 发 信和 失败 错误 。 这 些 错误 默认 是 关闭 的 。 link] 


# config/environments/development.rb 


config.action mailer.raise delivery errors = true 


e 在 开发 环境 下 使 用 诸如 Mailcatcher 的 本 地 SMTP JI 4-3 o ink] 


# config/environments/development.rb 


config.action mailer.smtp settings = ( 
address: 'localhost', 
port: 1025, 
# 更 多 设置 

} 


e 为 域名 设置 默认 项 。[linK] 


# config/environments/development.rb 
config.action mailer.default url options = ( host: "#{local ip) 


4 config/environments/production.rb 
config.action mailer.default url options - ( host: 'your site.c 


4 在 mailer 类 中 
default url options[:host] = 'your site.com' 


图 


e 若 需 要 在 邮件 中 添加 到 网 站 的 超 链 接 ， 应 总 是 使 用 _url 方法 ， 而 非 
path Zik» url 方法 产生 的 超 链接 包含 域名 ， 而 _path 方法 产生 相 


对 链接 。 [ink] 





You can always find more info about this course 
<%= link to 'here', course path(Qcourse) 96» 


You can always find more info about this course 
<%= link to 'here', course url(Qcourse) 96» 


正确 地 设置 寄 件 人 与 收 件 人 地 址 的 格式 。 应 使 用 下 列 格 式 : link] 


# 在 你 的 mailer 类 中 
default from: 'Your Name «infoQyour site.com»' 


确保 测试 环境 下 的 email 发 送 方法 设置 为 test : link] 


4 config/environments/test.rb 


config.action mailer.delivery method - :test 


开发 环境 和 生产 环境 下 的 发 送 方法 应 设置 为 smtp : Nk 


# config/environments/development.rb, config/environments/prodtu 


config.action mailer.delivery method - :smtp 


当 发 送 HTML 邮件 时 ， 所 有 样式 应 为 行内 样式 ， 这 是 因为 某 些 客户 端 不 能 正 
确 显 示 外 部 样式 。 然 而 ， 这 使 得 邮件 难以 维护 理 并 会 导致 代码 重复 。 有 两 个 类 
似 的 gem 可 以 转换 样式 ， 并 将 样式 放 在 对 应 的 html 标签 里 : premailer-rails3 
[ink] 





fe roadie ° 
避免 在 产生 页 面 响应 的 同时 发 送 邮件 。 若 有 多 个 邮件 需要 发 送 ， 这 会 导致 页 面 
加 载 延 迟 甚至 请 求 超时 。 有 鉴于 此 ， 应 使 用 sidekiq 这 个 gem 在 后 台 发 送 邮 
件 。[link] 





Time 


e 在 application.rb 里 设置 相应 的 时 区 。 ink] 


config.time zone = 'Eastern European Time' 
H 可 选 配置 一 注意 取 值 只 能 是 :utc X :local 中 的 一 个 (默认 为 :utc) 


config.active record.default timezone = :local 


e 不 要 使 用 Time.parse 。 [link] 


8 E 
Time.parse('2015-03-02 19:05:37') 4 => 会 假设 时 间 是 基于 操作 系统 的 时 
aa Si 
Time.zone.parse('2015-03-02 19:05:37') # => Mon, 02 Mar 2015 1€ 


BEES 





e 不 要 使 用 Time.now ° [link] 


H 差 
Time .now # => 无 视 所 配置 的 时 区 ， 返 回 操作 系统 时 间 。 
Hof 


Time.zone.now £ => Fri, 12 Mar 2014 22:04:47 EET +02:00 
Time.current # 结果 同上 ， 但 更 简洁 


Bundler 


e 只 在 开发 环境 或 测试 环境 下 使 用 的 gem 应 进行 适当 的 分 组 。[ink] 

e 在 项 目 中 只 使 用 广为人知 的 gem。 如 果 你 考虑 引入 某 些 鲜 为 人 所 知 的 gem » 
应 该 先 仔细 检查 一 下 其 源 代 码 。[ing] 

e 关于 多 个 开发 者 使 用 不 同 操作 系统 的 项 目 ， 与 操作 系统 有 关 的 gem 默认 情况 
下 会 产生 经 常 变动 的 Gemfile.lock » 4& Gemfile 文件 里 ， 所 有 与 OS X 相 
关 的 gem 放 在 darwin 群 组 ， 而 所 有 与 Linux 有 关 的 gem 应 放 在 linux 
群 组 : [link] 


# Gemfile 

group :darwin do 
gem 'rb-fsevent' 
gem 'growl' 

end 


group :linux do 
gem 'rb-inotify' 
end 


要 在 正确 的 环境 下 加 载 合适 的 gem， 需 添加 以 下 代码 至 
config/application.rb 


platform = RUBY PLATFORM.match(/(linux|darwin)/)[0].to sym 
Bundler.require(platform) 


e 不 要 把 Gemfile.lock 文件 从 版 本 控制 里 移 除 。 这 可 不 是 一 个 随机 产生 的 文 
件 一 一 它 的 目的 是 确保 你 所 有 的 团队 成 员 执 行 bundle install 时 ， 获 得 相 


同 版 本 的 gem 。 [link] 


有 缺陷 的 Gem 


这 是 一 个 有 问题 的 或 有 更 好 替代 物 的 gem 列表 。 不 要 在 项 目 中 使 用 它们 。 
e rmagick - 这 个 gem 因 大 量 消耗 内 存 而 臭名 昭著 。 应 使 用 minimagick AER 


o 


[e 
e autotest - 测试 自 动 化 的 过 时 方案 , APA guard 和 Watchr ° 
e rcov - 代码 覆盖 率 工 具 ， 不 兼容 Ruby 1.9。 应 使 用 SimpleCov 来 替代 它 。 


e therubyracer - 内 存 杀 手 ， 强 烈 不 建议 在 生产 环境 中 使 用 。 建 议 使 用 
node.js 来 替代 它 。 


这 仍 是 一 个 完善 中 的 列表 ， 欢 迎 添加 流行 但 有 缺陷 的 gem » 


进程 管理 


nj 


。 如 果 项 目 依赖 各 种 外 界 的 进程 ， 应 使 用 foreman 来 管理 它们 s link] 


Rails 风格 指南 


延伸 阅读 


以 下 是 几 个 极 好 的 讲述 Rails 风格 的 资源 ， 闲 暇 时 可 以 考虑 延伸 阅读 : 


The Rails 4 Way 

Ruby on Rails Guides 

The RSpec Book 

The Cucumber Book 

Everyday Rails Testing with RSpec 
Better Specs for RSpec 


延伸 阅读 
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页 献 


本 指南 的 每 条 建议 都 不 是 定案 。 我 渴望 与 对 Rails 编码 风格 有 兴趣 的 大 家 一 起 协 
作 ， 创 造 出 一 份 对 整个 Ruby 社区 都 有 益 的 资源 。 


欢迎 open tickets 或 发 送 带 有 改进 的 pull request。 在 此 提前 感谢 您 的 帮助 ! 
您 可 以 通过 gittip 对 本 项 目 (以 及 RuboCop 项 目 ) 进行 捐赠 支持 。 


(v) Suppor via Gittip 





如 何 页 献 ? 


只 需 遵循 贡献 指南 即 可 。 


许可 十 
This work is licensed under a Creative Commons Attribution 3.0 


Unported License 


口 耳 相传 


一 份 社 区 驱动 的 风格 指南 ， 若 不 为 人 所 知 ， 那 有 何 用 。 ns quo T 
份 指南 变 得 更 


享 给 你 的 朋友 或 同事 。 我 们 得 到 的 每 个 评论 、 建 议 或 意见 都 可 以 让 这 
好 一 点 。 而 我 们 想 要 拥有 的 是 尽 可 能 好 的 指南 ， 不 是 吗 ? 


Xf 
Bozhidar 


